v2026.7.5: : Worktree-Aware Trust and npm 12 Support

Compare Source

This release makes config trust smarter across git worktrees and monorepos, and fixes npm-backed tools on npm 12.

Added

• Trust is shared across git worktrees. Trust records are keyed by absolute path, so every new git worktree add checkout used to re-prompt for the same config. A config inside a linked worktree is now trusted automatically when the equivalent path in the repository's main checkout is trusted — trusting a repo once covers all of its worktrees. This is especially helpful for workflows that spin up many short-lived worktrees (e.g. AI-agent worktrees under .claude/worktrees/). Sharing flows one way, from main checkout to worktrees; an explicit --ignore still wins, and paranoid mode is excluded since its trust is tied to per-file content hashes. mise untrust inside a worktree now warns that the main checkout still trusts the config (#​10890 by @​jdx).
• mise trust --all now trusts nested subdirectory configs. Previously --all only trusted config files in the current directory and its parents. It now also walks subdirectories and trusts each nested config root it finds, so a monorepo's nested configs can be trusted with one explicit command. The walk respects .gitignore, skips hidden directories, and skips node_modules, vendor, target, dist, and build so vendored configs are left untrusted. Each nested config gets its own trust record, so a config added later in a new subdirectory still prompts (#​10889 by @​jdx).

Fixed

• npm: support npm 12 output. npm 12 wraps npm view --json responses in a single-item array, which broke version listing and latest-version detection for npm-backed tools. mise now normalizes both the legacy object shape and the new wrapped shape, and tolerates missing time metadata (#​10888 by @​jdx).

Changed

• registry: the codex shorthand now prefers npm:@​openai/codex over the aqua GitHub asset. The aqua asset for recent releases shipped only the main codex binary and omitted codex-code-mode-host, which broke tool calling; the npm package installs the full vendor bundle. Aqua remains available as an explicit or fallback backend (#​10893 by @​jdx).

Full Changelog: jdx/mise@v2026.7.4...v2026.7.5

💚 Sponsor mise

mise is maintained by @​jdx, an open source developer for entire.io, the title sponsor of the jdx.dev open source tools. Development is funded by sponsors.

If mise saves you or your team time, please consider sponsoring at jdx.dev. Individual and company sponsorships keep mise fast, free, and independent.

v2026.7.4: : Bootstrap goes stable

Compare Source

This release graduates mise bootstrap and mise dotfiles out of experimental mode, teaches mise install to reconcile Rust components and targets, and restores Linux arm64 glibc compatibility for release builds.

Added

• Bootstrap and dotfiles are now stable. mise bootstrap and all of its subcommands (packages, repos, macOS/Linux user services, shell activation, login shell) plus mise dotfiles no longer require experimental mode, so they work with MISE_EXPERIMENTAL=0. The related mise doctor diagnostics (system packages, macOS defaults, login-shell drift) and the missing [bootstrap.packages] hint on mise install are always on as well (#​10869 by @​jdx).
• Skip re-installs in the mise.run install script. Setting MISE_INSTALL_SKIP_IF_EXISTS avoids re-downloading mise when the requested version is already present at the install path, which is handy for CI/Docker builds that re-run the installer on every build (#​10882 by @​JamBalaya56562):

  curl https://mise.run | MISE_INSTALL_SKIP_IF_EXISTS=1 sh

  Only the resolved install path is checked (not the wider PATH), and default behavior is unchanged unless you opt in.

Fixed

• install: the Rust backend now asks rustup whether the configured components and targets are actually installed before skipping an install, so mise install reconciles missing components/targets on an already-installed toolchain instead of treating a bare symlink as complete. Array-form config is now parsed (with trimming and empty-entry filtering) and host-suffixed component names are matched (#​10876 by @​jdx).
• task: task_source_files() is once again available when a task defines usage args and its run script is re-rendered with parsed CLI values (#​10870 by @​jdx).
• upgrade: mise upgrade --minimum-release-age no longer prints a misleading "newer release ignored" warning when the installed version already satisfies the hidden latest release (#​10877 by @​jdx).
• build: pinned the aarch64-unknown-linux-gnu cross image back to a fixed tag and added a shared glibc-floor check to release packaging, restoring predictable glibc compatibility for Linux arm64 tarballs (#​10875 by @​jdx).

Performance

• install: missing-version detection now runs each backend's install-satisfaction check in parallel, speeding up detection for larger tool sets (a follow-up to the Rust reconciliation work). If the parallel batch fails it falls back to a sequential pass so the missing list stays accurate (#​10881 by @​jdx).

Changed

• registry: the Scala shorthand now resolves to the canonical vfox:mise-plugins/vfox-scala fork; the asdf:mise-plugins/mise-scala fallback is unchanged (#​10864 by @​jdx).

Documentation

• Fixed the broken bootstrap docs intro, linked the bootstrap sub-pages, and made a style/consistency pass across the bootstrap pages (#​10878, #​10880 by @​jdx).
• Fixed broken source-code links in the generated CLI reference (#​10879 by @​jdx).

Aqua Registry Updates

New packages: sderosiaux/launchdeck, syntax-sh/lexicon-releases.

Full Changelog: jdx/mise@v2026.7.3...v2026.7.4

💚 Sponsor mise

mise is maintained by @​jdx, an open source developer for entire.io, the title sponsor of the jdx.dev open source tools. Development is funded by sponsors.

If mise saves you or your team time, please consider sponsoring at jdx.dev. Individual and company sponsorships keep mise fast, free, and independent.

v2026.7.3: : System dependency checks and cask lifecycle hooks

Compare Source

This release brings smarter builds for source-compiling tools, better Homebrew cask support, and a fix for lockfile entries losing their platform data during upgrades.

Added

• vfox: plugin-declared system dependencies. Source-compiling plugins (php, mysql, erlang, ...) often need build tools and libraries that previously showed up only as a failed ./configure twenty minutes into a build. vfox plugins can now declare these prerequisites in metadata.lua, and mise checks them before installing (#​10848 by @​jdx):

  PLUGIN.systemDependencies = {
      { bin = "bison", version = ">=3.0", packages = { brew = "bison", apt = "bison" } },
      { pkgconfig = "libxml-2.0", packages = { brew = "libxml2", apt = "libxml2-dev" } },
      { sharedlib = "libaio.so.1", packages = { apt = "libaio1" } },
  }

  Detection is the source of truth: a satisfied check passes regardless of how the capability was installed (Homebrew, apt, nix, from source), and the per-manager packages map is only used to offer installing the missing subset. A new system_deps setting controls behavior (prompt default, auto, warn, ignore); the check never fails an install. Missing deps also show up in mise doctor and mise bootstrap status. Declarations are inert on older mise versions and on upstream vfox.

• brew: cask lifecycle hooks. Homebrew cask installs now run supported preflight and postflight hooks via a mise-owned, sha256-verified Ruby shim (no brew delegation), which fixes wrapper-style casks like GIMP. Unsupported hook DSL fails with an explicit error (#​10837 by @​jdx).

• cli: terminal width override. In some CI environments width detection returns a bogus value and mise's table/list output (mise ls, mise registry, mise settings) renders oddly with no way to fix it. You can now override the detected width (#​10862 by @​JamBalaya56562):

  MISE_TERM_WIDTH=120 mise ls

  MISE_TERM_WIDTH takes precedence, with COLUMNS as a fallback. An explicit override is honored exactly (no 80-column floor); behavior is unchanged when neither is set.

Fixed

• upgrade: mise upgrade --bump can rewrite more lockfile entries than the tools it actually installs. Those rewritten entries were previously reduced to bare version/backend records, losing their cross-platform checksums and URLs. mise now re-locks stale entries that are missing platform metadata, so tools like ruff, biome, and typos keep their full lock data (#​10752 by @​zeitlinger).
• brew: casks whose binary is created by a pkg installer at an absolute path (e.g. karabiner-elements) now install correctly, staged through the caskroom as symlinks (#​10841 by @​jdx).
• vfox: traditional vfox plugin downloads now go into mise's per-tool download directory so they are cleaned up after install (#​10840 by @​risu729).
• brew: included the cask shim in the published crate, fixing a cargo publish verification failure (#​10863 by @​jdx).

Changed

• registry: switched a large batch of tools to the vfox backend: scala, groovy, mongodb, emsdk, teleport-community, teleport-ent, tinytex, mysql, elasticsearch, v, spring-boot, php, clojure, oci, jib, graalvm, gcc-arm-none-eabi, and tiny.

Documentation

• De-slopified the landing page copy and visuals (#​10836 by @​jdx).

Full Changelog: jdx/mise@v2026.7.2...v2026.7.3

💚 Sponsor mise

mise is maintained by @​jdx, an open source developer for entire.io, the title sponsor of the jdx.dev open source tools. Development is funded by sponsors.

If mise saves you or your team time, please consider sponsoring at jdx.dev. Individual and company sponsorships keep mise fast, free, and independent.

v2026.7.2: : Template and Extraction Fixes

Compare Source

This is a small bug-fix release focused on template compatibility, archive extraction, and a couple of tool-specific installs.

Fixed

• config: restored the get_env template helper for Tera v2 templates, backed by mise's original process environment, so older templates keep working. Shared configs can also opt back into the temporary Tera v1 renderer with [env] MISE_TERA_V1 = true (which older mise versions safely ignore) (#​10830 by @​jdx):

  [env]
  MISE_TERA_V1 = "true"

• config: deprecated settings that you set explicitly, via [settings] (including nested keys like aqua.registry_url), process env vars, or the MISE_TERA_V1 [env] shim, now produce proper deprecation warnings. Warnings are held until the logger is ready so they honor -q, --silent, and --log-level, and no longer fire spuriously for unrelated MISE_* values (#​10832 by @​jdx).
• file: PAX GNU.sparse.* tar archives (such as the smolvm release tarballs) now extract correctly by falling back to the system tar when the built-in extractor can't safely unpack sparse content (#​10821 by @​JamBalaya56562).
• registry: podman now installs with the expected podman binary name instead of podman-remote-static, removing the need for manual symlink workarounds (#​10822 by @​konono).
• vfox: vfox plugin HTTP downloads now flush to disk before reporting success, fixing a race where freshly downloaded files could be read back as empty (#​10833 by @​jdx).
• github: cached GitHub asset URLs with scoped release tags (e.g. Biome's @biomejs/biome@2.5.2) are now accepted, so mise no longer rejects otherwise-valid download URLs and falls back to the GitHub API (#​10750 by @​zeitlinger).

Full Changelog: jdx/mise@v2026.7.1...v2026.7.2

💚 Sponsor mise

mise is maintained by @​jdx, an open source developer for entire.io, the title sponsor of the jdx.dev open source tools. Development is funded by sponsors.

If mise saves you or your team time, please consider sponsoring at jdx.dev. Individual and company sponsorships keep mise fast, free, and independent.

v2026.7.1: : Tera v2 Templates and Safer Pruning

Compare Source

Added

• config: temporary tera_v1 / MISE_TERA_V1 escape hatch to keep rendering templates with the old Tera v1 engine after the upgrade to Tera v2 (scheduled for removal in 2027.4.0) #​10817
• cargo: experimental cargo.binstall_native fast path that installs prebuilt native binaries from crate package.metadata.binstall when cargo-binstall is unavailable, falling back to cargo install on misses #​10789
• bootstrap: start_calendar_interval support for macOS launchd agents, allowing calendar-based schedules (hour/minute/day/weekday/month) in addition to start_interval #​10797
• npm: trust_policy_excludes install option for aube installs to exempt reviewed packages from trust-policy downgrade checks without disabling the policy globally #​10783

Fixed

• config: upgraded to the Tera v2 template engine, with v1 compatibility filters restored, delayed v1 compat warnings, and the tera_v1 escape hatch for templates that still need the old behavior #​10756 #​10814 #​10815 #​10817
• env: redaction wildcards are now matched as globs, fixing over-redaction where patterns like *_KEY scrubbed unrelated values from task output #​10729
• env: resolve sops keys from the ordered env #​10786
• env: resolve sub-*:latest requests offline during shell activation so already-installed versions are no longer reported as missing #​10802
• prune: don't delete tool versions referenced by executed tool stubs; stubs are now tracked so mise prune and mise upgrade retain the versions they need #​10790
• cli: --run-windows is now honored by task add and emitted as run_windows in the generated TOML #​10769
• search: mise search now falls back to the built-in aqua registry when the mise registry has no match (e.g. mise search 7zip surfaces aqua:ip7z/7zip) #​10801
• cargo: accept array syntax for features and warn on invalid feature array entries #​10810 #​10813
• backend: accept native option shapes and arrays for list options #​10811 #​10812
• install: normalize standalone binary ownership and avoid preserving archive owner on extraction #​10808 #​10819
• system: extract suffixless brew cask zip archives #​10800
• brew-cask: expand font target paths to handle $HOME and return relative paths #​10788
• github: handle raw exe rename #​10798
• git: sanitize repository env vars #​10776
• lockfile: preserve header url while restoring asset host, and avoid provenance guesses for opaque tags #​10728 #​10722
• oci: normalize apt/dpkg transient state for reproducible package layers #​10731
• core: don't panic when stderr is unwritable #​10773
• core: improve precompiled setting errors and clarify python precompiled triple errors #​10791 #​10793
• logger: fix race between log redaction and config reset #​10785
• nushell: resolve str upcase deprecation warning #​10778
• task: show usage subcommand help #​10799
• schema: support vars directives and allow tool alias versions #​10774 #​10712
• vfox/http: create parent directories in download helpers #​10767
• restore $LASTEXITCODE after _mise_hook #​10718

Documentation

• clarify env_shell_expand setting #​10787
• clarify Go backend version pinning #​10749
• fix config precedence visual #​10779
• update Tera documentation links #​10751

Registry

• prefer aqua for pi #​10727
• add twg #​10780, apm #​10766, nono #​10675, miniserve #​10760

💚 Sponsor mise

mise is maintained by @​jdx, an open source developer for entire.io, the title sponsor of the jdx.dev open source tools. Development is funded by sponsors.

If mise saves you or your team time, please consider sponsoring at jdx.dev. Individual and company sponsorships keep mise fast, free, and independent.

v2026.7.0: : Shell expansion by default, monorepo lockfiles, and task usage mounts

Compare Source

Added

• env: enable shell expansion by default; opt out with env_shell_expand = false (#​10702 by @​jdx).
• monorepo: mise install --monorepo and mise ls --monorepo install/list the union of tools across [monorepo].config_roots; new tri-state [monorepo].lockfile for unified root lockfiles (#​10707 by @​jdx).
• task: root-level #USAGE mount ... in file tasks (including shorthand mount "cmd") hoists mounted usage specs onto the generated task command (#​10704 by @​jdx).
• github: per-tool github_attestations option to disable GitHub Artifact Attestation verification for a single tool (#​10694 by @​jdx).
• upgrade: minimum_release_age warnings now include the release date, when the version becomes eligible, and the effective cutoff value (#​10705 by @​jdx).
• bootstrap: brew formulae prune is now prefix-inventory based and can remove any linked formula outside the resolved [bootstrap.packages] closure (#​10618 by @​jdx).
• brew: support cask font artifacts and additional non-install artifact types (completions/manpages) (#​10671 by @​roele).
• platform: Android asset detection for tools like Termux packages (#​10653 by @​bltavares).

Fixed

• install: respect the lockfile-recorded backend during --locked installs (#​10599 by @​risu729).
• install: installer prints a clearer message and suggests cargo install --locked mise on unsupported architectures (#​10627 by @​risu729).
• install-into: refuse to overwrite a non-empty target directory without --yes (#​10630 by @​JamBalaya56562).
• aqua: resolve bin paths with v-prefixed version overrides (e.g. sharkdp/fd@10.3.0) (#​10696 by @​jdx).
• aqua: download private GitHub release assets via the API asset endpoint when the browser URL 404s (#​10622 by @​yacchi).
• brew-cask: handle raw executable binaries, resolve $APPDIR paths, and use ditto for app bundle copying to avoid macOS "damaged app" errors (#​10626 by @​arthurh4).
• config: preserve set values in mise config set for comma-separated set-typed settings (#​10647 by @​KrishRVH).
• config: render task_config.includes templates with resolved vars (#​10700 by @​jdx).
• config: support required validation and redact = true on [vars]; render tool option templates recursively (#​10697 by @​jdx).
• dotnet: validate SDK installs with dotnet --list-sdks so global.json roll-forward no longer causes false failures (#​10691 by @​jdx).
• generate: mise generate tool-stub --lock respects configured lockfile_platforms (#​10709 by @​JamBalaya56562).
• github: handle missing/empty url_api in older lockfile entries, falling back to the cached browser URL (#​10703 by @​jdx).
• hooks: set MISE_INSTALLED_TOOLS=[] on no-op installs so postinstall always receives a valid JSON array (#​10615 by @​JamBalaya56562).
• http: don't let netrc credentials clobber explicit forge tokens on un-redirected URLs, fixing private GitHub release asset downloads (#​10713 by @​yacchi).
• lockfile: merge platform data when a tool's options newly diverge from an empty on-disk entry (e.g. java shorthand_vendor), preventing checksum/URL loss (#​10710 by @​JamBalaya56562).
• npm: map allow_builds to npm 11.16+ --allow-scripts / --dangerously-allow-all-scripts instead of forcing --ignore-scripts (#​10690 by @​jdx).
• oci: canonicalize install paths when rebasing PATH, fixing mise oci on systems with symlinked /home (Bluefin/Silverblue) (#​10624 by @​salim-b).
• oci: account for darwin mode stripping in layer test expectations (#​10681 by @​laozc).
• ruby: stop forcing no-yjit Ruby builds on older glibc (#​10620 by @​jdx).
• sigstore: retry GitHub attestation verification with the TUF trust root after embedded-root failures; workflow mismatches remain non-retryable (#​10695 by @​jdx).
• task: render monorepo subproject task templates with the subproject's own [env]; broken subprojects no longer fail discovery repo-wide (#​10706 by @​jdx).
• task: correct env used for the task.show_full_cmd setting (#​10714 by @​muzimuzhi).
• vfox: Lua os.getenv now reads from mise's env table like cmd.exec/os.execute (#​10719 by @​jdx).
• watch: forward --ignore, --ignore-file, and --print-events to watchexec (#​10629 by @​JamBalaya56562).
• windows: allow GHCUp to be installed on Windows via aqua (#​10670 by @​cprecioso).
• copr: drop retired Fedora 42 chroots from the default build list (#​10698 by @​jdx).

Security

• Ignore transitive quick-xml advisories RUSTSEC-2026-0194/-0195 pending upstream fixes (#​10717 by @​jdx).

💚 Sponsor mise

mise is built by @​jdx under en.dev — an independent studio making developer tooling (mise, aube, and more). Development is funded by sponsors.

If mise saves you or your team time, please consider sponsoring at en.dev. Individual and company sponsorships keep mise fast, free, and independent.